.lf 1 ./xctool.1
.pl 29.7c
.\\" $Id: xctool.1,v 1.3 2004/07/11 08:04:47 bhepple Exp $
.TH XCTOOL 1 "Tue Nov 3 1992" "\&\(co Bob Hepple"
.UC 4
.SH NAME
xctool \- an XVIEW (OpenWindows) X-windows shell for running
.B "Screen Manager"
programs.
.SH SYNOPSIS
.B xctool
[
.I ... XVIEW options
]
[
.B \-rc
.I command
[
.I "command arguments"
]]
.SH DESCRIPTION
.B xctool
provides an XVIEW shell for running the interactive
.B "Screen Manager"
commands such as
.BR smcreate ,
.BR smdata ,
.B smproj
and
.BR smedit .
Buttons and pull-down menus are provided for frequently required
operations such as \fILoad\fR, \fIStore\fR, etc. and the mouse is
available for positioning the cursor (any button), selecting function
key labels (left button up), popup fields (right button down) and
moving and scrolling of popup menus (left button up selects the item).
.LP
The operation of the mouse buttons is interesting.
Normally, XVIEW
uses the left, middle and right mouse buttons as \fISelect\fR,
\fIExtend\fR, and \fIMenu\fR.
At startup,
.B xctool
turns this function off so that the mouse can be used with the
subsidiary command.
To reinstate the normal XVIEW mouse function,
there is a toggle button marked
.IR Selection .
When the normal selection service is on, the mouse does not trigger
events in the underlying command.
.SH OPTIONS
.TP
\fB -rc \fIcommand\fR
.B xctool
will run
.B smproj
as a default unless the
.B -rc
option is given.
For example, to run
.B smcreate
instead:
.LP
.RS
\fBxctool -rc smcreate addr.dat&
.RE
.TP
.B Other X-windows options
These are passed to the XVIEW package as usual.
.SH ENVIRONMENT
.TP
.B DEBUGCTOOL
If set, debugging statements are sent to the console window.
.TP
.B CTOOL
The default command to use in place of
.BR smproj .
.SH "SEE ALSO"
Postscript version of these man pages which have screenshots -
probably in /usr/share/doc/scrmgr-X.Y.
.LP
.lf 1 ./xctool.lst
.BR scrmgr (1),
.BR sm2awk  (1),
.BR sm2c  (1),
.BR smcalc (1),
.BR smclean (1),
.BR smcreate  (1),
.BR smdata (1),
.BR smedit (1),
.BR smfind (1),
.BR smgrep (1),
.BR smproj  (1),
.BR smquick  (1),
.BR smsort (1),
.BR smtree (1),
.BR smupdate  (1),
.BR smdisp (1),
.BR pcurse (1)
.lf 81 ./xctool.1
.SH BUGS
Use of fonts other than the default \fIfixed\fR font is untested and
may not work.
.LP
Windows resize events are not passed to the underlying command.
.LP
As with certain other XVIEW packages (e.g.
.BR pageview ),
.B xctool
aborts on receipt of the SIGTSTP signal (stop) usually generated by
the ^Z character from
.BR csh (1)
or
.BR bash (1)
in an attempt to put the job in background.
For this
reason, always put
.B xctool
in the background with the \fB'&'\fR character, as in the above
example.
.SH AUTHOR
Bob Hepple <bhepple@freeshell.org>
.SH COPYRIGHT
Copyright \(co 1991-2002 Bob Hepple
